home *** CD-ROM | disk | FTP | other *** search
- 32bit Service Monitor
-
- Table of Contents
-
- --------------------------------------------------------------------------
- Subject: Item Number:
- --------------------------------------------------------------------------
- 1. About This Manual 1
- Buttons and Dialog Box Items 1
-
- 2. Getting Started 2
- Installing 32bit Service Monitor 2
-
- 3. [Global Options] Tab 3
- Global Options 3
- Session Log File Status 3
-
- 4. Configure/Monitor Services 4
- Service X ]> 4
- Service X 4
- Define Service 4
- Configure Alerts 4
- Select Alerts 4
- Status Area 4
-
- 5. Activity Log 5
- Activity Log 5
-
- 6. Menu Items 6
- Exit 6
- SessionLog 6
- Sound 6
- Help 6
- Register 6
- --------------------------------------------------------------------------
- End Table of Contents
-
-
- Item 1 - About This Manual
-
- - Buttons and Dialog Box Items
-
- While reading this manual, words in square brackets [ ] will be in
- reference to [Buttons and Dialog Box Items].
-
-
- Item 2 - Getting Started
-
- - Installing 32bit Service Monitor
-
- Go to http://www.electrasoft.com/32bs.htm and download the newest version.
- During installation, it will ask you for your registration name and email
- address. Enter the name and email address you want 32bit Service Monitor
- to be registered to. This is the name and email address that you will be
- known to us at ElectraSoft as.
-
-
- Item 3 - [Global Options] Tab
-
- - Global Options
-
- - Use System Tray
- Check this if you want 32bit Service Monitor to minimize to the system
- tray instead of the Windows Task Bar.
-
- - Hide in Tray at Startup if [Tray] is Checked
- Check this if you want 32bit Service Monitor to hide in system tray at
- startup.
-
- - Show only first line of response in Activity Log
- If you are checking a large file, like index.htm, it may not be
- necessary to fill the Activity Log with the contents of this file.
- check this check box so it will only show a one line response.
-
- - Max services examined simultaneously
- This is the number of services that will be checked at simultaneously.
- ie: If you have 20 services being monitored and when they are checked,
- if you only want to check 2 at one time then check the next 2 when those
- checks have completed, you would set this value to [2].
-
- - Max number of services available
- This is the number of services that will be able to br monitored at
- the same time. The number of services available will be the number of
- service tabs you will be able to select under [Configure/Monitor
- Services]
-
- Deciding how many services to select:
- Each service that you allow uses considerable memory and resources.
- Whether or not you fill in the service forms or run them, they use
- approximately the same amount of memory. So if you need to monitor
- more services, select as many as you need. If you need less services,
- you should select less.
-
- - Session Log File Status
-
- - No session log file
- Select this if you do not want 32bit Service Monitor to keep any session
- logs.
-
- - One log file, append to it each session
- Select this if you want 32bit Service Monitor to keep one session log
- and append each session's log to it.
-
- - New log file with new name each session
- Select this if you want 32bit Service Monitor to create a new session
- log for each session of 32bit Service Monitor.
-
- - Delete all Session Log files on exit
- Check this to have 32bit Service Monitor delete any session log files
- saved. This will take place upon exiting 32bit Service Monitor.
-
-
- Item 4 - [Configure/Monitor Services] Tab
-
- - Service X ]>
-
- This is the first item in the tab. It is a drop down list box. You can
- select which service to view/configure with this list. The following
- settings for the [Configure/Monitor Services] Tab will be in all of the
- Service X tabs. Where X is a number between 1 and the [Max number of
- services available], which is selected in the Global Options.
-
-
- - Service X
-
- These are tabs 1 - 20 that are services you can choose to view/configure.
- In any of these tabs, the following fields and information will be there:
-
-
- - Define Service
-
- - Service Name
- This is where you can specify the name of the service you want to
- monitor. This is for your reference, so you can identify a certain
- service.
-
- - Host/Site/IP
- This is where you specify the host/IP address of the service you want to
- monitor. ie: If you wanted to monitor youw web site at
- http://www.mygreatsite.com , you would enter:
- [www.mygreatsite.com] in this field (without the square brackets).
-
- - Command/Script (optional)
- You can type in a single command or a reciprocal script.
-
- Running a Command/Script:
- If the service checks ok, then it looks to see if there is a command or
- script to be run. If there is no command or script, the service check
- returns and logs an ok. If there is a command or script, it must also
- check ok if the service check is to log an ok.
-
- Script Format:
- The odd lines (1,3,5,7,etc) are sent to the service. The even lines
- (2,4,6,8,etc) are the responses that you are expecting from the service.
- In most cases only the significant characters of the response are
- needed. For instance, if the expected response is [220 Please enter your
- user name], you would only need to put 220 as the response line. Then
- you can send an optional QUIT and expect back a response of [221-You
- have transferred 0 bytes in 0 files. See the port [21 ftp] example
- below.
-
- How the Command/Script Works:
- The first line is sent to the service. The next line is compared to the
- response from the service. If the response is the same as the script
- line, the service is checked as ok. If not, it is logged as an error. If
- the script has an uneven number of lines, the script will always return
- ok, because being that the last expected response is not defined, the
- response is logged but it is not considered while determining the error
- condition.
-
- Command/Script example for port [80 http]:
- ---- start script ----
- GET /
- 200
- ---- end script ----
- This script will read your default home page. This is usually
- index.html, index.htm, or default.html. GET /thispage.htm will
- read thispage.htm and GET /thispage.html will read thispage.html.
-
- If the script is successful, it will return with something like:
- HTTP/1.1 200 OK
- If the script fails, it will return with something like:
- HTTP/1.1 302 Found
-
- The format may change a little from one server to another.
- 32bit Service Monitor will resolve this for you. You are only
- interested in the numbers 200 and 302.
-
- Command/Script example for port [21 ftp]:
- ---- start script ----
- USER UserName
- 220
- PASS PassWord
- 230
- QUIT
- 221
- ---- end script ----
-
- Command/Script example for port [25 smtp]:
- ---- start script ----
-
- 220
- QUIT
- 221
- ---- end script ----
- Note that the first line of this script can be a blank line. If we make
- a good connection, we may not need to send a command to get a responce.
- As with an SMTP, we need to get the 220 responce to the succsessful
- connect. So the first line of the Script should be blank. If it is
- blank, we will not send the command, but we will receive the SMTP 220
- responce to the connect. Then we send the command QUIT, and the SMTP
- will respond with a 221.
-
- If you have a one line command or script ie: [GET /]. The command will
- show in the activity log. The response will also show in the activity
- log, but the check will always be seen as checking ok. This ok scenario
- assumes that everything else was ok up to the point of running the
- command or script. If there is an error making connect with the service
- before the script is run, the check will return an error. When the user
- define number of failed or errored checks are satisfied, the user
- defined alerts will be activated.
-
- - Port (0 - 65535)
- Port is where you can specify the port number on the remote [Host, Name,
- or IP] that is being monitored. The port used for a web site is usually
- port [80 http]. An FTP site is usually on port [21 ftp]. In the list of
- port numbers, the service name usually used on that port appears next to
- the number.
-
-
- - Configure Alerts
-
- - Minutes between checks
- This is where you specify the number of minutes between checks on the
- specified service being monitored.
-
- - Failed checks before alert
- This is where you specify the number of failed checks before you are
- alerted.
-
- - Timeout, seconds (20)
- This is where you specify the amount of time to keep trying to check a
- service. The default is 20 seconds. If 20 seconds is specified, the
- service will be given 20 seconds to respond before being counted as a
- failed check.
-
- - Select Alerts
-
- In order from top to bottom and left to right:
-
- - Error Sound
- Check this to have 32bit Service Monitor play the Windows default error
- sound when the service is down.
-
- - Play WAV file
- Check this to have 32bit Service Monitor play a specified WAV file when
- the service is down.
-
- - Repeatedly
- Check this to have 32bit Service Monitor play the specified sound in a
- continuous loop until the service is back up or until you uncheck it.
-
- - Browse
- Click this button to browse and select a WAV file to play if
- [Play WAV file] is checked.
-
- - Test
- Click this button to test the sound currently selected.
-
- - Show Alert Message Box
- Check this to have 32bit Service Monitor pop up an alert window when the
- service is down.
-
- - Send Email at Beginning of Alert
- Check this checkbox to have 32bit Service Monitor email a message to
- you, telling you when the service goes down. This message can be
- emailed to one email address or to a whole list of email addresses.
-
- - Edit Email
- Click this button to edit the email message that will tell you the
- service is down.
-
- - Send Email at Ending of Alert
- Check this checkbox to have 32bit Service Monitor email a message to
- you, telling you when the service is back up. This message can be
- emailed to one email address or to a whole list of email addresses.
-
- - Edit Email
- Click this button to edit the email message that will tell you the
- service is back up.
-
- - Pager
- Check this to have 32bit Service Monitor notify you by a pager when the
- service is down.
-
- - Page Setup
- Click this button to edit the settings for the pager and modem settings.
-
- - Execute Program
- Check this to have 32bit Service Monitor start a specified program when
- the service is down.
-
- - Browse
- Click this button to browse and select an executable file to run if
- [Execute Program] is checked.
-
- - Test
- Click this button to test the executable currently selected.
-
-
- - Status Area
-
- - Monitor Service
- When this is checked, the current service will be monitored.
-
- - Reset
- Click this button to: reset the number of failed checks to 0, check
- the service right away, and start the count down to check the servicefrom the top.
-
- - Errors and Alert
- Errors<X> tells you the number of times the service has been down on a
- check. Where X is the number of times.
-
- Alerts<X> tells you how many failed checks is required before alerting
- you that the site is down.
-
-
- Item 5 - [Activity Log] Tab
-
- - Activity Log
-
- Here is where you will see the activity log since 32bit Service Monitor
- was started. When you exit and start the program, the activity log will
- clear and start a new log in here for the session.
-
-
- Item 6 - Menu Items
-
- - Exit
-
- Click this to exit 32bit Service Monitor.
-
-
- - SessionLog
-
- Click this to open the current Session Log/Activity Log in your Windows
- default text editor.
-
-
- - Sound
-
- - Sound, Enable/Disable
- When [Disable] is clicked, the sound alerts in 32bit Service Monitor
- will be disabled. If there are any sounds queued to be played from an
- alert, the events will be deleted and the sounds will not be played. The
- next time the Sound menu is brought down, it will read [Enable] instead
- of [Disable], or vice versa.
-
- - Sound, Flush Queue
- When [Flush Queue] is clicked, any sound that is queued to be played due
- to an alert, will be deleted and the sounds will not be played.
-
-
- - Help
-
- Click this to bring up the menu of help and information items.
-
-
- - Register
-
- If you are an unregistered user (If you have not paid for 32bit Service
- Monitor), then you will see this menu item. Click it if you wish to
- register (Pay for 32bit Service Monitor).
-
- You can try 32bit Service Monitor before you buy it. If you want to
- continue using this software after trying it, you must purchase it by
- registering it with ElectraSoft. This means you have a chance to test the
- performance of 32bit Service Monitor before committing yourself to buying
- it. Before paying, you will only be able to monitor one service at a time.
- After you pay ElectraSoft for the use of [32bit Service Monitor], you will
- be able to monitor up to five services at a time.
-